Skip to content

docs(roadmap): add upstream A2A interoperability workstream - #113

Merged
imran-siddique merged 1 commit into
mainfrom
docs/roadmap-a2a-interop
Aug 17, 2026
Merged

docs(roadmap): add upstream A2A interoperability workstream#113
imran-siddique merged 1 commit into
mainfrom
docs/roadmap-a2a-interop

Conversation

@imran-siddique

Copy link
Copy Markdown
Member

Records a workstream that was agreed but written down nowhere: running cA2A against the upstream A2A conformance and interoperability harnesses, and publishing the result with the gaps included.

Our own tests/conformance/ suite answers "does this peer implement cA2A". It does not answer "does attaching the profile keep us compatible with the rest of the A2A ecosystem", which is a separate question and a more interesting one to have numbers for.

Two things in here are guardrails rather than plan, because both are easy to get wrong:

  • The system under test is an official a2a-sdk server with the extension attached through ca2a_runtime.transport.a2a_sdk, not ca2a start. LIMITATIONS.md puts a normative A2A transport out of scope, so a conformance suite aimed at the reference standard-library transport would fail baseline MUSTs for reasons that say nothing about the profile.
  • The protobuf Struct integer-ness round trip already documented in transport/a2a_sdk.py is tested safe in Python only. Go and Rust are assumptions, and the ITK launcher now covers both.

Docs only, no code paths touched.

Our conformance suite says a peer implements cA2A. It says nothing about
whether attaching the profile keeps us compatible with the wider A2A
ecosystem. Records the plan to answer that with numbers: a2a-tck first,
then the A2A Interoperability Test Kit multi-language launcher.

Also records two things that are easy to get wrong. The system under test
is an a2a-sdk server with the extension attached, not `ca2a start`, since
a normative A2A transport is out of scope for the profile. And the
protobuf Struct integer-ness round trip is only tested safe in Python.
@imran-siddique
imran-siddique merged commit 0bc7e8c into main Aug 17, 2026
12 checks passed
@imran-siddique
imran-siddique deleted the docs/roadmap-a2a-interop branch August 17, 2026 18:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant